home *** CD-ROM | disk | FTP | other *** search
/ Especial Multimedia / Especial Multimedia.iso / Multimed / Visuali / IMGVIEW.ZIP / README.TXT < prev    next >
Text File  |  1996-12-03  |  9KB  |  203 lines
  1. ImgView Utility - Copyright (c) 1996 - Abri Technologies, Inc.
  2. ======================================================
  3.  
  4. INTRODUCTION:
  5. =============
  6. ImgView is a Image file viewer capable of displaying 
  7. JPG/PCX/GIF/BMP/TIF/ICO/PNG/SCM/WMF image file formats. The main advantage 
  8. of ImgView is that it can be parameter driven from your own application.
  9. ImgView is an inexpensive solution to displaying various image formats
  10. in FoxPro/Win applications and possibly other app types.
  11.  
  12. If this is a demo copy you can either start ImgView.exe from program 
  13. manager or run the FoxPro/Win2.6 demo1.app and demo2.app to see how ImgView 
  14. can be controlled from a FoxPro app. The foxpro demos are compiled in 
  15. FPW2.6 but registered ImgView will have required Foxpro source code usable
  16. from VFP.
  17.  
  18. NOTICE: GIF and TIF files use compression methods patented by Unisys 
  19. corporation. A license is required from Unisys corporation, except for 
  20. personal or BBS use.
  21.  
  22. ImgView.exe USAGE:
  23. ==================
  24. ImgView.exe called by itself:
  25. (from window manager, etc.) will display a file Open dialog for image 
  26. files. After getting a suitable image file it will display the image in a 
  27. window.
  28.  
  29. ImgView.exe with parameters:
  30. ImgView.exe ImgFilePath ScreenPos ImgSize ImgTitle
  31.  
  32. Parameters:
  33. 1 ImgFilepath: pathname, must have bmp,jpg,cpx..., extension
  34.   IF no other parameters:
  35.     photo is centered, full size, dialog frame with <OK> button
  36. 2 ImgPos: C for centered or TOP_LEFT if wrt 0,0 or TOP/LEFT if wrt centre
  37.     of screen
  38.   IF no other parameters: photo is full size, no frame
  39. 3 ImgSize: HEIGHT_WIDTH or A for auto sized to full bitmap size
  40.   IF no other parameters: no frame
  41. 4 ImgTitle: Image is displayed in a dialog frame with <OK> button
  42.  
  43. Examples:
  44. ImgView.exe custmr03.jpg 0_0 A
  45.   displays image custmr03.jpg in current directory with top left corner at 
  46.   top left screen position and full size of the image.
  47.  
  48. ImgView.exe c:/photos/photo23.pcx C 200_400 "My Photo"
  49.   displays the c:/photos/photo23.pcx image in a dialog centered on the 
  50.   screen, limited to 200 height and 400 pixel width, with title "My Photo" 
  51.   and and an <OK> button at bottom of screen.
  52.  
  53. ImgView.exe photo3.gif -20/-90
  54.   displays the image photo3.gif in current directory with top left corner 
  55.   20 pixels left from screen centre and 90 pixels up from screen 
  56.   centre. The image is shown full size.
  57.  
  58. FoxPro source code for demo1 and demo2 apps is included with registered copy.
  59.  
  60. FoxPro Usage Notes:
  61. ===================
  62. GetImg() and CloseImg() foxpro function source code is included with registered 
  63. copy.
  64.  
  65. GetImg(ImgFilePath, ScreenPos, ImgSize, ImgTitle)
  66. All parameters are in string form. ImgFilePath is required. Other 
  67. parameters are optional. Example: =GetImg("Photo7.pcx")
  68.  
  69. CloseImg(ImgTitle)
  70. ImgTitle parameter is not required if the image is frameless - it is set to 
  71. "ImgView" if it is not specified. You cannot have null title.
  72. Examples: =CloseImg(), =CloseImg("My Photo")
  73. If you are displaying frameless images you should use CloseImg() when 
  74. exiting your app dialog or window, otherwise the image will stay where it 
  75. is.
  76.  
  77. Required files:
  78. ===============
  79. Required files are IMGVIEW.EXE, SKY16V3C.DLL - and FOXTOOLS.DLL for 
  80. FoxPro/WIN/VFPwin applications.
  81.  
  82. Except for demo use, SKY16V3C.DLL should be in the current directory or in 
  83. WINDOWS search path - prefererably in WINDOWS/SYSTEM directory.
  84.  
  85. For FoxPro/Win/VFP you need a copy of foxtools.fll with library already set 
  86. to it, or a copy in same directory where foxpro .exe started.
  87.  
  88. GetImg() uses Foxtools.fll to find the main FoxPro window Hwnd handle which 
  89. is passed on to ImgView.exe through temporary file imgview1.hwn. The handle 
  90. is used to reset focus to Foxpro windows. ImgView can also get this info 
  91. via windows clipboard - see GetImg function doc (registered copy) for doing 
  92. this.
  93.  
  94. CloseImg() uses Foxtools.fll to send a close-window message to ImgView.exe. 
  95. If an ImgTitle is used in GetImg(), exactly the same ImgTitle must be used 
  96. in CloseImg function.
  97.  
  98. The utility CloseImg.exe is also included with registered copy and can be used
  99. as an alternative to CloseImg() - i.e. "RUN /N CloseImg.exe" if ImgTitle is
  100. not used and "RUN /N CloseImg.exe ImgTitle" if it is used. If you are not using
  101. ImgView from FoxPro you may need to omit the "RUN /N" part. Example for
  102. the second type: "RUN /N CloseImg.exe My Photo".
  103.  
  104. DISPLAY MODES:
  105. ==============
  106. 1. Displays the image in ImgView window with an <OK> button
  107. 2. Displays a frameless topmost image on the screen at any desired
  108. position. This is useful for simulating an image painted on your own
  109. application screen. Problems with this case are a) the image is static - 
  110. does not move with your window b) the image stays on the main screen 
  111. position when you switch window apps.
  112. Recommend: Construct your app dialogs/windows (having the image) so that 
  113. they are non movable and do not switch from your app to another window app. 
  114. as long as the image is showing.
  115.  
  116. ImgView should work OK even when you switch screen resolution. For 
  117. application windows that are not centered use the TOP_LEFT position spec. 
  118. and for centered screen apps use the TOP/LEFT (relative to centre) position 
  119. specs.
  120.  
  121. ImgView Vers.1.0 License Agreement and Disclaimer 
  122. ============================================================================= 
  123. SINGLE USER LICENSE:
  124. Registration of the single license entitles the original purchaser, to use 
  125. it on a single computer by a single user for each copy purchased.
  126.  
  127. DISTRIBUTABLE ROYALTY FREE LICENSE:
  128. Registration of entitles you, the original purchaser, to royalty free 
  129. distribution of ImgView.exe with your own legitimate application (.APP or 
  130. .EXE), as long as your application was generated on single CPU by same 
  131. programmer/developer and ImgView is used only within your own application. 
  132. You cannot have any intention of distributing copies of ImgView.exe for 
  133. free or for gain of any type.
  134.  
  135. SITE LICENSES:
  136. Available per user (single user license) or per developer (royalty free 
  137. license).
  138.  
  139. DISCLAIMER:
  140. This software is supplied as is without warranty of any kind. Abri 
  141. Technologies, Inc. disclaims all warranties, expressed or implied, 
  142. including, without limitation, the warranties of merchantability and of 
  143. fitness for any purpose. Abri Technologies assumes no liability for 
  144. damages, direct or consequential, which may result from the use of 
  145. this software.
  146.  
  147. ImgView Order Form / Information:
  148. =================================
  149. -------------------------------------------------------------------------
  150.   Date:_________________
  151.  
  152.   Quan       Item                             _US funds_  Price
  153.  
  154.   ___ Single/Personal User License             $ 25 each $_________
  155.          
  156.   ___ Royalty free license                     $ 50 each $_________
  157.  
  158. ================== Site Licenses ====================================
  159.   ___ Add 50% of price per user for single user license   $_________
  160.       or per developer for royalty free license
  161.  
  162.                                       Shipping/handling   $  3.00
  163.  
  164.                             Outside of N. America add $1  $_________
  165.  
  166.                                                   TOTAL   $_________
  167. --------------------------------------------------------------------
  168.  Send by: [ ] CompuServe ___________________________________________
  169.  
  170.           [ ] Internet (mime E-Mail)________________________________
  171.           [ ] DownLoad from Abri Technology Host (phone first)
  172.           [ ] Mail - Disk media:  5.25" [  ]  3.5" [  ]
  173. --------------------------------------------------------------------
  174. Address: (where to send invoice/receipt)
  175.  
  176.          Name_______________________________________________________
  177.  
  178.       Company_______________________________________________________
  179.  
  180.       Address_______________________________________________________
  181.  
  182.              _______________________________________________________
  183.  
  184.       Phone  ________________________ (in case of shipping problems)
  185.  
  186.    If payment by: VISA[ ]  MasterCard[ ]  AmericanExpress [ ]
  187.  
  188.    CardNumber____________________________  ExpDate______
  189.    
  190.    NameOnCard____________________________
  191. ----------------------------------------------------------------------------
  192.       Please fill out the above order form and/or mail/E-Mail/Phone
  193.       with payment to:
  194.  
  195.                     Abri Technologies, Inc.,
  196.                     HC 62 Box 100K,
  197.                     Great Cacapon, WV 25422 USA
  198.  
  199.                     Phone: (304) 947-7129.
  200.             E-Mail: info@abri.com or 72345.1623@compuserve.com
  201.  
  202. NOTICE: No refunds after software has been shipped.
  203.